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• QTable dan altsınıf oluşturulması 

• Yükle ve Kaydet 

• Düzenle menusunun ifası 

• Diğer menülerin ifası 

• OTahle dan altsınıf oluşturulması 



Spreadsheet Programının Beyninin Kodlanması 

Sabik iki böümde Spreadsheet programının kullanıcı arabiriminin nasıl oluşturulduğunu 
gördük. Bu bölümde Elektronıik çizelge programının beyni diye nitelendirebileceğimiz 
kısmını kodlayacağız. Bu bölümde öğreneceklerimizin başında, dosya yükleyüp kaydetmek, 
bellekte data muhafaza etmek ve pano operasyonları (kes ve yapıştır gibi) ile QTable sınıfına 
elektronik çizelge programında kullanılacak olan formülleri anlama yeteneğinin 
kazandırılması geliyor. ;; 

Merkezi Alet 

QMainWindow un merkezi kısmını herhangi bir alet işgal edebilir. İşte muhtemel bir kaç 
metod: 

1 . standart Qt aleti kullan. 

QTable veya QTextEdit gibi standart Qt aleti merkezi alet olarak kullanılabilir. Bu 
durumda, programın dosya yükleme ve kaydetme gibi faliyetleri başka bir yerde ifa 
edilmelidir (mesela bir QMainWindow alt sınıfında ). 

2. özel bir alet kullan. 

Özel amaçlı programlar genellikle hususi tasarlanmış aletlere ihtiyaç duyarlar. Mesela, 
bir simge muharriri (IconEditor) merkezi aleti olarak doğaş olarak IconEditor aleti 
kullanır. Beşinci bölümde Qt altında hususi aletlerin nasıl yapılabileceğini işleyeceğiz. 

3. Bir dizim (layout) ile birlikte adi bir QWidget kuullan. 

Bazan bir ptoğramm merkezi bölümü bürden fazla alet tarafından istila edilmiş olabilir. 
Bütün bu aitlerin atası olaran bir QWidget ile çocuk aletlerin mahalleri ve ebatlarını 
tanzim etmek için bir dizim kullanmak suretiyle bu geröekleştirilebilir. 

4. Ayırıcı (splitter) kullan. 

Müteaddid aletleri bir arada kullanmanın yollarından biriside bir ayırıcı sınıfı olan 
Qsplitter kullanmaktır. QSplitter çocuklarını ya QHBox gibi yatay olarak yan yana veya 
QHBox gibi düşey olarak çocuklar arasında kullanıcının yer değşitirebileceği bir ayırıcı 
olacak şekilde tertib eder ki buda kullanıcıya aletlerin ebatlarını tebdil etmesini mümkün 
kılar. Ayırıcılar her tür alet ihtiva ettiklri gibi diğer ayırıcılar dahi içerebilirler. 
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5. MDI kullan. 

Eğer program MDI kullanıyorsa bu durumda merkezi alanmm QWorkspace aleti (iş 
alam) kaplar, ve MDI .öerisindeki her bir pencere QWorkspace aletinin çocuğuduralr. 

Dizim mekanizmaları (layouts), ayırıcılar (splitters), ve MDI iş alanları diğer Qt standart 
aletleri ile kullanılabilecekleri gibi husui aletler ile de kullanılabilirler. Altıncı bölümde 
esnafı sabıka tafsilen ele alınacaktır. 

Spreadsheet programında QTable m bir alt sınıfı merkezi alet olarak kullanıldı. QTable bir 
elektronik çizelge programında ihtiyaç duyulan çoğu işlevi tedarik etmekle birlikte 
=A1+A2+A3 gibi formüller ile kes yapıştır panosu operasyonlarını desteklememektedir. 
Proğramımızca şhtiyaç duyulan bu istidadları QTable m alt sınıf olan Spreadsheet sınıfına 
kodlayacağız. 

QTable dan Altsınıf Oluşturulması 

Başlık dosyasından başlayarak Spreadsheet aletini kodlayacağız: 

#ifndef SPREADSHEET_H 

#define SPREADSHEET_H .; '| 

#include <qstringlist .h> 
#include <qtable.h> class Celi; 

class SpreadsheetCompare; 
Başlık dosyasında önce Celi ve SpreadsheetCompare sınıflarının ön tanımlarını yapıyoruz. 
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Şekil 4.1: Spreadsheet ve Celi (hücre) sınıflarının soy ağacı. 

QTable hücrelerinin, metin (text) ve hiza (alignment) gibi vasıfları Qtableltem içerisinde 
muhafaza edilmektedirler. QTable sınıfının aksine QTableItem bir alet sınıfı olmayıp bilakis 
saf bir veri veya data sımfıdr. Celi sınıfı ise QTableItem m bir alt sınıfıdır. Standart 
QTableItem vasıflarına ilaveten Celi sınıfı hücreye ait formülü muhafaza eder. 

Bu bölümğn son kısmında Celi sınıfının kodunu yazarken bu sınıf hakkında detaylı bilgi 
verilecektir. 

class Spreadsheet : public QTable 
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Q_OBJECT 
public : 

Spreadsheet (QWidget ^parent = O, const char ^name = 0); 

void clear^ ( ) ; 

QString currentLocationM ) const; 

OString currentFormulaM ) const; 

bool autoRecalculate ( ) const { return autoRecalc; } 

bool readFile (const QString &fileName) ; 

bool writeFile (const QString &fileName) ; 

QTableSelection selection(); 

void şort (const SpreadsheetCompare &compare) ; 

Spreadsheet sınıfı QTable sınıfının varisidir (alt sınıfıdır). QTable dan alt sınıf oluşturulması 
QDialog veya QmainWindow dan alt sınıf oluşturulması gibidir. 

Üçüncü bölümde, MainWindow oluşturuken Spreadsheet sınıfının umumi (public) 
fonksiyonlarından bir hayli yararlandık. Mesela, MainWindow:: newFile() içerisinden clear() 
fonksiyonunu çağırmak suretiyle elektronik çizelgeyi yeni dosya için hazır hale getirdik 
(reset). Yine QTable dan miras kalan setCurrentCellO gibi setShowGrid() fonksiyonları 
kullandık. 

public slots : ,.'] 

void cut ( ) ; .'i 

void copy ( ) ; 

void paste ( ) ; 

void del ( ) ; 

void selectRow(); 

void selectColumn ( ) ; 

void selectAllO; 

void recalculate ( ) ; 

void setAutoRecalculate (bool on) ; 

void findNext (const QString &str, bool caseSensitive) ; 

void findPrev (const QString &str, bool caseSensitive); 
signals : 

void modified(); 

Spreadsheet Düzenle, Aletler ve Seçenekler menülerinin işlevlerini yerine getiren bir çok 
dilim (slot) tedarik etmektedir. 

protected: 

QWidget ^createEditor (int row, int col,bool initFromCell) const; 
void endEdit(int row, int col,bool accepted, bool wasReplacing) ; 

Spreadsheet, QTable sınıfının iki fonksiyonunu yeniden tanımlar, ki bunlar QTable 
tarafından, kullanıcı hücre içindeki değeri değiştirmeye başlayınca, çağrılırlar. Elektronik 
çizelgenin formülleri anlayabilmesi için bu iki fonksiyonu yeniden tanımlamamız gerekli. 

private : 
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^ aktif yer 
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aktif formül 
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enum { MagicNumber^ =0x7F51C882, NumRows5 =999, NumCols^ =26 }; 

Celi ^cell(int row, int col) const; 

void setFormula (int row, int col, const QString &formula) ; 

OString formula(int row, int col) const; 

void somethingChanged^ () ; 

bool autoRecalc; 

}; 

Sınıfın hususi (private) kısmında üç tane sabit değişken (constants), dört fonksiyon ve bir 
değişken tanımlıyoruz. 

class SpreadsheetCompare 

{ 

public : 

bool operatör O (const QStringList &rowl, 

const QStringList &row2) const; 
enum { NumKeys = 3 } ; 
int keys [NumKeys] ; 
bool ascending [NumKeys ] ; 

}; 

#endif 

Başlık dosyası SpreadsheetCompare sınıfının tanımıyla sona erdi. Bunu Spreadsheet::sort() 
sınıfını ele alırken açıklayacağız. Şimdi başlık dosyasında tanımlanan fonksiyon ve sınıflara 
oşlevlik verecek kodu yazacağız ve ger bir fonksiyonu açıklayacapız: 

#include <qapplication .h> 
#include <qclipboard.h> 
#include <qdatastream.h> 
#include <qfile.h> 
#include <qlineedit .h> 
#include <qmessagebox .h> 
#include <qregexp.h> 
#include <qvariant.h> 

'■■■ I 

#include <algorithm> 
#include <vector> 
using namespace std; 

#include "cell.h" 
#include "spreadsheet .h" 

Programda kullanılacak olan Qt sınıflarının başlık dosyalarını dahil etmekle birlikte 
standart C++ ta mevcut olan <algorithm> ve <vector> başlık dosyalşarımda dahil ediyoruz, 
using namespace komutu std mmtıkasmdaki (namespace) bütün sembolleri küresel yada 
global mıntıkaya ithal eder böylece std mmtıkasmdaki mevcut herşeye std:: önekini 
kuUanmaksızm ulaşabiliriz. Bu demek oluyorki std::stable_sort() ve std::vector<T> terine 

^ sihirli rakam 

^ satır sayısı 

^ sütun sayısı 

^ birşey değişti 



Bölüm 4 5 

stable_sort() ve vector<T> kullanarak bunlara ulaşabiliriz. 

Spreadsheet : : Spreadsheet (QWidget ^parent, const char ^name) 
: QTable (parent, name) 

{ 

autoRecalc = true; 

setSelectionMode (Single) %• 

clear ( ) ; 
} 

Yapıcıda (constructor) QTable seçme modune Single (tek) olarak belirledik. Buda elektronik 
çizelge programında her defasında ancak bir dikdörtgenlik alan seçilebilir. 

void Spreadsheet : : clear ( ) 
{ 

setNumRows (O ) ; 

setNumCols (0) ; 

setNumRows (NumRows ) ^ ; 

setNumCols (NumCols)!^ . 

for (int i = 0; i < NumCols; i++) 

horizontalHeader () ->setLabel (i, 

setCurrentCell (O, 0) ; 
} 



QChar ( A + i) 



clearO fonksiyonu Spreadsheet yapıcısı (constructor) tarafından elektronik çizelgeyi 
hazırlamak için çağrılır. Bu fonksiyon, yukarıdada belirtildiği gibi, MainWindow::newFile() 
tarafındanda çağrılır. Biz ünce elektronik öşzelgeyi 0x0 boyutuna getirerek bir bakıma 
onun muhteviyatını siliyoruz ve daha sonra boyutunu NumCols x NumRows (26 x 999) 
olarak deüiştiriyoruz. Sütun etiketlerini A , B , &, Z olarak değiştiriyoruz (bunun sebebi 
QTable da sütunlar 1 , 2 , &, 26 şekline numaralandırılmalarıdır ) ve imleci Al hücresine 
yerleştiriyoruz . 
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Şekil 4.2: QTable bileşeninin ihtiva ettiği aletler. 

QTable çok sayıda çocuk bileşeninden ibarettir. Üstte yatay bir QHeader (başlık), solda 
düşey bir QHeader sağda düşey QScrollBar (kaydırma çubuğu) ve altta yatay bir 
QScrollBar mevcuttur. Merkezi alan vievport diye adlandırılan bir bileşim tarafından işgal 



^ seçmeModunuBelirle(tek) 

^ satırSayısınıTesbitEt(satırSayısı) 

^° sütunSayısınıTesbitEt(sütunSayısı) 
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edilmektedir, ki bu alet üzerine QTable hücrelerini çizer. Muhtelif çocuk aletlere QTable ve 
onun üst sınıfı olan QScrollView içerisinde mevcut fonksiyonlar vasıtasıyla ulaşılabilir. 
Mesela, clearO fonksiyonu içerisinde, tablonun üst başlığına (QHeader ) QTable:: 
horizontalHeaderO vasıtasıyla ulaşıyoruz. 



Dataları Ferd (Item) Olarak Bellekte Saklamak 



Elektronik çşzelge programında, boş olmayan her bir hücre hafızada ferdi QTableItem 
nesnesi olarak saklanır. Bu şekilde dataların bellekte tutulması QTable sınıfına mahsus 
değildir; Qt nin QIconView, QListBox, ve QListView sımflarıda fertlerle 
c(QIconViewItems, QListBoxItems, and QlistViewItems) çalışırlar. 

Qt nin bu sınıflarını bu kitapta içeren yada ihtiva eden manasında muhtevi sınıfları diye 
tabir edeceğiz ki onlar hiç bir değişikliğe gerek kalmadan data tutmak için 
kullanılabilirler. Mesela, QTableItem hali hazırda bir metin (string), bir pixmap ve birde 
QTable için bir müşir (pointer) ihtiva eder. QTable sınıfından alt sınıf oluğturmak 
suretiyle bir kaç data daha ekleyebilir ve bu data üzerinde iş yapacak bir kaç hayali 
(virtual) fonksiyon ekleyebiliriz. 

Çok sayıda kütüphaneler (toolkits) ferd sınıflarında hususi dataların tutulabilmesi için 
umumi müşir tedarik ederle. Qt, gereksiz yere her bir ferde müşir ilave etmek yerine, 
programcının ferd sınıfından bir alt sınıf oluşturarak gerekli dataları orada tutmasını veya 
varsa mevcut dataya bir müşir eklemesini mümkün kılar. Eğer umumi müşire (void 
pointer) ihtiyaç duyulursa bu durumda ferd sınıfından bir alt sınıf oluşturulur ve umumi 
müşir bu sınıfa üye değişken olarak eklenir. 

QTable sınıfının alte seviye fonksüyonları ola paintCellO ve clearCellO yeniden 
tanımlamak suretiyle ferd makanizmasınm kullanımasma gerek kalmayabilir. Hücrelerde 
görüntülenecek olan data hafızada başka bir data yapısında mevcut ise ferd 
mekanizmasının kullanılmaması müreccehhdir taki aynı datanm hafızada birden fazla 
yerde tutulması önlenmiş olsun. Ayrıntıları Qt Quarterly da yer alan A ModeWiew Table 
for Large Datasets pasajında bulabilirsiniz ki bu magazini ağda şu URL de bulabilirsiniz: 
http://doc.trolltech.com/qq/qq07-big-tables.html. 

Qt 4 ün Qt 3 ten data tutma konusunda daha esnek olması bekleniyor. Qt 4, ferdleri 
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QScrollView sınıfı doğal olarak cok miktarda datayı teşhir edecek olan sınıfların üst sınıfıdır. 
O kaydırılabilir bir viewport (bkz. Şekil 4.2) ile iki tanede kaydırma çubuğu tedarik eder ki 
bu çubuklar arzu edildiğinde saklanabilirler. Altıncı bölümde bu sınıfı detaylı olarak ele 
alacağız. 

Celi ^Spreadsheet : : celi (int row, int col) const 

{ 

return (Celi ^)item(row, col) ; 

} 

Hususi cellO fonksiyonu belirli bir satır ve sütuna ait olan Celi nesnesine verir. Bu hemen 
hemen Qtable::item() fonksiyonu ile aynıdır, ancak Celi müşiri yerine QTableItem müşiri 
verir. 

OString Spreadsheet : : f ormula (int row, int col) const 

{ 

Celi ^c = cell(row, col) ; 
if (c) 

return c->f ormula () ; 
else . *,, 

return ""; ' ;| 

} 

Hususi formulaO fonksiyonu her bir hücreye ait formülü verir. Eğer cell() bir boş müşir 
verirse bu hücrenin boş olması anlamına gelir böylece boş bir metin geri gönderiyoruz. 

void Spreadsheet :: setFormula (int row, int col, 

const OString &formula) 
{ 

Celi ^c = cell(row, col) ; 

if (c) 

{ 

c->setFormula (f ormula) ; 

updateCell (row, col)^^; j, ı 

} 

else 

{ 

setItem(row, col, new Cell(this, formula) ) ; 

} - - 
} 

Hususi setFormulaO fonksiyonu sıra ve sütun numarası verilen hücrenin formülünü tesbit 
eder. Eğer bu hücrenin hali hazırda Celi nesnesi mevcut ise onu kullanıyoruz ve updateCellO 
fonksiyonunu çağırark QTable a hücre şayet ekranda görünen bir pozisyonda ise onu 
güncelleştirmesini istiyoruz. Aksi takdirde bir Celi nesnesi meydana getiriyoruz ve 
QTable::setItem() fonksiyonunu çağırarak onu tabloya yerleştirip ekranda göstermesini 
sağlarız. Celi nesnesini daha sonra silinmesi hususunda kafa yormamıza gerek yok çünkü 
QTable bu nesneyi sahipleşir ve gerektiği vakitte onu siler. 

OString Spreadsheet :: currentLocation ( ) const 



hücreyiGüncelleştir(sıra, sütun) 
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{ 

return QChar ( A + currentColumn ( ) ) + 

OString: : number (currentRow ( ) + 1); 
} 

currentLocationO fonksiyonu aktif hücre numarasını sütun harfi ve ardından satır numarası 
olarak verir. Bu fonksiyon MainWindow:: updateCellIndicatorsO tarafından aktif hücre 
numarasının durum çubuğunda gösterilmesi için istimal edilir. 

OString Spreadsheet : : currentFormula ( ) const 

{ 

return f ormula (currentRow ( ) , currentColumn ()) ; 

} 

currentFormulaO fonksiyonu aktif hücrenin formülünü verir. Bu fonksiyon MainWindow:: 
updateCellIndicatorsO tarafından çağrılır. 

QWidget ^Spreadsheet :: createEditor (int row, int col, 

bool initFromCell) const 



{ 



OLineEdit ^lineEdit = new QLineEdit (viewport ( ) 
lineEdit->setFrame (false) ; 
if (İnitFromCell) 

lineEdit->setText (formula (row, col) ) ; 
return lineEdit; 



} 



createEditorO fonksiyonu Spreadsheet sınıfına QTable dan miras kalmakla birlikte burada 
yeniden tanımlanmaktadır. Bu fonksiyon kullanıcı hücreye tıklayarak, F2 tuşuna basarak 
veya basitçe yazmaya başlamak suretiyle değiştirmeye kalktıpmda şağrıhr. Bunu görevi bir 
muharrir birleşim oluşturmaktırki bu alet hücrenin üzerinde görüntülenir. Kullanıcı 
içeriğini değiştirmek için hücreye tıklarsa veya F2 tuşuna basarsa, İnitFromCell değişkeni 
müsbet (true) olur ve muharrir aktif hücrenin işeriğini ihtiva eder bir şekilde başlatılır. 
Kullanıcı hücreye tıklamaksızm veya F2 tuğuna basmaksızm yazmaya başlarsa bu durumda 
hücrenin içeriği ihmal edilir. 

Bu fonksiyonun normalde bir QLineEdit oluşturur be İnitFromCell değişkeni müsbet ise bu 
muharrire hücrenin içeriğini kopyalar. Biz bu fonksiyonu yeniden tanımladık taki hücrenin 
içeriği yerine onun formülünü göstersin. 

QTable m viewport unun çocuğu olan bir QLineEdit oluşturuyoruz. QTable bunun 
boyutlarını değiştirilmekte olan hücre ebatlarına göre ayarlar ve sözkonusu hücrenin üzerine 
yerleştirir. QTable, ihtiyaç duyulmadığı takdirde QLineEdit i siler. 
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=A1İ 



Celi OLineEdit 

Şekil 4.3: Hücre ve değşitirme esnasında üzerine yerleştirilen QlineEdit. 

Çoğu zaman formül ve metin aynıdır, mesela Merhaba formülnün sonucu Merhaba metnidir. 
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Yani bir hücreye Merhaba yazıp Enter tuşuna basıldığında o hücre Merhaba metnini 
görüntüler. Bunun istisnaları şunlardır: 

• Eğer formül bir rakam ise o şekilde algılanır. Mesela formül 1,50 ise bu formülün sonucu 
bir doğal sayı olan 1,5 dir. Hücrede bu sayı sağa yanaşmış bir şekilde gösterilir. 

• Eğer formül "'" işareti ile başlarsabu durumda formül metin olarak algılanır. Mesela 
'12345' formülünün değeri 12345 metnidir. 

• Formül eşit işaretiyle ( = ) ile başlarsa bu durumda formül aritmetik ibare olarak 
algılanır. Mesela, Al hücresü 12 ve A2 hücresi 6 içeriyorsa, =A1+A2 formülünün sonucu 
18 dir. 

Formüllerin değerlendirilmesi vazifesi Celi sınıfına aittir. Şu aşamada akılda 
bulundurulması greken husus hücrede gösterilen metnin formülün kendisi değil bilakis 
formülün değerlendirilmesi sonucu elde edilen değer olmasıdır. 

void Spreadsheet : : endEdit (int row, int col, 

bool accepted, bool wasReplacing) 

{ 

OLineEdit ^lineEdit = (QLineEdit ^ ) cellWidget (row, col) ; 
if (llineEdit) return; 

OString oldFormula = f ormula (row, col); 

OString newFormula = lineEdit->text ( ) ; 

QTable :: endEdit (row, col, false, wasReplacing) ; 

if (accepted && newFormula != oldFormula) 



{ 



} 
} 



setFormula (row, col, newFormula) 
somethingChanged ( ) ; 



QTable sınıfının endEditO fonksiyonu burada yeniden tanımlandı. Bu fonksiyon kullanıcı 
hücreyi değiştirme işlemini bitirdiğinde iağrıhr, ki bu elektroniş öizelge üzerinede başka bir 
alana tıklamakla veya Enter tuşuna (yapılan değişikliği tasdik manasında) veya Esc tuşuna 
(yapılan değişikliği red manasında) basarakla yapılır. Bu fonksiyonun görevi muharririn 
içeriğini (QLineEdit), yapılan değişikliğin tasdik edilmesi durumunda, hücreye geri 
göndermektir. Muharrire Qtable::cellWidget() vasıtası ile ulaşılabilir. Bu fonksiyonun 
getirdiği aleti rahatlıkla QLineEdit e çevirebiliriz çünkü createEditorO içerisinde ouşturulan 
alet daima QLineEdit dir. 



|^A1+A2l I ^ 
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OLineEdit Celi 

Şekil 4.4: QlineEdit in içeriğinin hücreye kopyalanması. 

Fonksiyonun ortasında QTable sınıfının endEditO fonksiyonunu çağırıyoruz çünkü QTable 
değiştirme işlemini ne zaman bittiğini bilmesi lazım. endEditO fonksiyonunun üçüncü 
argümanı olarak menfî (false) kullanıyoruz taki tablonun ferdini değiştirmesin çünkü bu 
değişikliği biz yapacağız. Eğer yeni formül eskisinden farklı ise setFormulaO fonksiyonunu 
çağırmak suretiyle Celi nesnesini tadil edip sonrada somethingChangedO fonksiyonu 
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çağrılır. 

void Spreadsheet : : somethingChanged ( ) 
{ 

if (autoRecalc) 

recalculate ( ) ; 

emit modifiedO; 
} 

Hususi bir fonksiyon olan somethingChangedO, elektronik çizelegeni tamamını,seşeneği 
müsbete ayarlanmış ise, yeniden hesaplar ve modifiedO sinyalini yayınlar. 

Yükleme ve Kaydetme 

Şimdi Spreadsheet programının dosya yükleme ve kaydetme işlevini hususi bir binary 
format ile yapabilmesi için gerekli kodu yazacağız. Bu işlemi QFile ve QdataStream 
sınıflarını kullanarak işletim sisteminden bapımsız binary I/O olarak gerçekleştireceğiz. 
Spreadsheet dosyasının kaydedilmesi ile işe başlayacağız: 

bool Spreadsheet : :writeFile (const QString &fileName) 

{ 

QFile file (fileName) ; 

if ( ! file. öpen (IO_WriteOnly) ) 

{ 

QMessageBox: : warning (this, trUtfS ("Spreadsheet") , 

trUtf8("%l dosyas kaydedilemiyor : \n%2 . " ) 

. arg (f ile . name ( ) ) 

. arg (f ile . errorString ( ) ) ) ; 

return false; 

} 

ODataStream out(&file); 

out . setVersion (5) ; 

out << (Q_UINT32)MagicNumber; 

QApplication : : setOverrideCursor (waitCursor ) ; 

for (int row = 0; row < NumRows; ++row) 

{ 

for (int col = 0; col < NumCols; ++col) 

{ 

OString str = f ormula (row, col); 
if ( ! str . isEmpty ( ) ) 

out << (Q_UINT16) row 
<< (Q_UINT16) col 
<< str; 
} 
} 

QApplication : : restoreOverrideCursor ( ) ; 
return true; 
} 

writeFile() fonksiyonu MainWindow::saveFile() tarafindan dosyayı kaydetmek için çağrılır. 
Kaydetme işlemi başarıyla tamamlandı ise müsbet aksi takdirde menfi geri getirir. 

Verilen dosya ismini kullanarak bir QFile nesnesi oluşturup open() fonksiyonunu çağırarak 
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dosyayı açıyoruz. Aynı zamanda bir QDataStream nesnesi oluşturuyoruz ki bu nesne QFile 

üzerinde çalışmaktadır ve datanın kaydedilmesi için kullanılır. Datayı yazmadan önce 

programın imlecini bekle moduna alıp (genelde kum saati şekline görünür) datayı yazdıktan 

sonra imleci normal haline çeviriyoruz. Fonksiyonun sonunda dosya QFile imha edicisi 

(destructor) tarafından otomotik olarak kapatılır. 

QDataStream temel C++ datat türleri ile öahşabildiği gibi çok sayıda Qt datası ilede 
çalışabilir. QDataStream m nehvi standart <iostream> sınıflarına baenzer. Mesela , 

out « X « y « z; 

x,y, ve z değişkenlerini bir stream e yazar ve 

fin » X » y » z; 

bu değişkenleri bir stream den okur. 

Temel C++ tipleri olan char, short, int, long, ve long long farklı platformlarda farklı 
büyüklüğe sahip olabilir, bu bakımdan bunları Q_INT8, Q_UINT8, Q_INT16, Q_UINT16, 
Q_INT32, Q_UINT32, Q_INT64, ve Q_UINT64 çevirmek suretiyle büyüklüklrinin bütün 
platformlarda aynı olmasını garanti edebiliriz. 

QDataStream oldukça elverişlidir. QFile ile kullanıldığı gibi QBuffer, Qsocket ve 
QsocketDevice ile de kullanılabilir. Benzer şekilde QFile, QdataStream yerine QTextStream 
ile hatta raw (çiğ) data ile dahi kullanılabilir. Onuncu bölümde bu sınıflar tafsilen ele 
alınacaklardır. 

Spreadsheet programının dosya formatı gayet basittir. Bir Spreadsheet dosyasi 32-bit bir 
yayı ile başlar ki bu sayı (MagicNumber diye 0x7F51C882 olarak spreadsheet.h dosyasında 
tanımlandı) dosyanın formatını gösterir. Bunun ardından her bir hücrenin sair, sütun 
numarası ile formülünü içeren bloklar gelir. Diskte fazla yer kaplamamk için boş hücreleri 
katdetmiyoruz. 



Ox7F5lC882] | 122|| 4"|[Hğ] | 122|| 5]|M&rcury 



Şekil 4.5: Spreadsheet programının dosya formatı. 

Data türlerinin tam anlamı ile ne şekilde kaydedildiği QdataStream tarafından belirlenir. 
Mesela, bir Q_UINT16 big-endian sırasında iki byte ile temsil edilir, ve bir QString 
uzunluğunu mütaakip Unicode karekterleri tarafından temsil edilir. 

Qt türlerini binary formatmda temsil edilme şekli Qt 1.0 dan bu tana bir hayli değişti. 
Muhtemelen istikbaldede değişmeye devam edecektir bunu sebebei ise mevcut türlerin 
değişmeşisine izin vermek ve başka tiplerin eklenmesine izin vermektir. By default, 
QDataStream en yeni binary formatı (Qt 3.2 altında, versiyon 5), kullanmaktadır, ancak 
eski versiyonları okumakta mümkündür. Spreadsheet programının, Qt nin daha yeni 
versiyonları ile derlendiğinde, uy arlılık problemlerini engellemek için QDataStream m 
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daima 5 versiyonunu kullanmasını sağlayacağız. 

bool Spreadsheet : : readFile (const QString &fileName) 
{ 

QFile file (fileName) ; 

if ( ! file. öpen (IO_ReadOnly) ) 

{ 

QMessageBox: : warning (this, trUtfS ("Spreadsheet") , 
_ trUtfS ("Dosya okunamad %l:\n%2.") 

^ ""* . arg (f ile .name ( ) ) 

. arg (f ile . errorString ( ) ) ) ; 
return false; 

} 

QDataStream in(&file); 

in . setVersion (5) ; 

Q_UINT32 magic; 

in >> magic; 

if (magic != MagicNumber) 

{ 

QMessageBox: : warning (this, truTFS ("Spreadsheet") , 
truTF8("Bu dosya geçerli bir " 
"Spreadsheet dosyas delidir")); 

return false; 
} 

clear ( ) ; 
Q_UINT16 row; 
Q_UINT16 col; 
QString str; 

QApplication : : setOverrideCursor (waitCursor ) ; 
while ( ! in.atEndO ) 
{ 

in >> row >> col >> str; 

setFormula (row, col, str); 

} 

QApplication : : restoreOverrideCursor ( ) ; 
return true; 
} 

readFileO fonksiyonu writeFile() fonksiyonuna çok benzer. QFile kullanarak dosyayı 
okuyoruz andcak bu defa IO_WriteOnly yerine IO_ReadOnly seçeneğini kullanıyoruz. 
Sonra QDataStream versiyonunu 5 olarak ayarlıyoruz. Okurken kullanılan format yazarken 
kullanılan formatm aynısı olmalıdır. 

Eğer dosya sihirli numara ile başlıyorsa clear() fonksiyonunu çağırarak bütün hücreleri 
boşaltıyoruz ve datayı okuyoruz. Dosyada yer almayan hücreleri temizlemek için clear() 
fonksiyonunu kullanmak eşzemdir. 

Düzenle Menüsü 

Şimdi sıra Düzenle menüsü için gerekli olan dilimleri programlamaya geldi. 

void Spreadsheet :: cut ( ) 
{ 
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copy ( ) ; 
delO; 



} 

cutO dilimi Düzenle I Kes menüsüne tekabül eder. Kes komutu aslında ünce kopyala ve sonra 
sil komutundan ibaret olduğu işin kodlanması gayet basittir. 



Edit 






U ^^i 


Ctrl+ X 




[5 Çopy 


Ctrl+ C 




1^ Faste 


Ctrl+V 




^ Delete 


Del 




Select 


^ 


Row 
Çoiumn 


Ca fînd... 


Ctrl+ F 


fe- Goto Celi... 


FS 


^1 Ctrl+A 



Şekil 4.6: Spreadsheet programının Düzenle menüsü. 

void Spreadsheet : : copy ( ) 

{ 

QTableSelection sel = selectionO; '• J 

QString str; 

for (int i = 0; i < sel . numRows ( ) ; ++i) 

{ 

if (i > 0) str += "\n"; 

for (int j = 0; j < sel . numCols ( ) ; ++j) 

{ 

if (j > 0) 

str += "\t"; 

str += formula (sel . topRow O + i, sel . leftCol ( ) + j); 

} 
} 
QApplication : : clipboard ( ) ->setText (str) ; 



} 



copyO dilimi Düzenle I Kopyala menüsüne tekabül eder. Seçilmiş alan içerisindeki bütün 
hücreler üzerinde çalışır. Seçilmiş olan her bir hücrenin formülü bir QString te tutlur ve 
sıralar yeni satır karakteri ile ve sütunlar ise tab ile birbirlerinden ayrılırlar. 




"Red\t GreenVt BlueVn CyanVt MagentaVt Yellovv" 



Bölüm 4 
14 

Şekil 4.7: Seçilmiş bir kısmın panoya kopyalanması. 

Qt altında işletim sisteminin panosuna QApplication::clipboard() sakin (static) fonksiyonu 
vasıtası ile ulaşılabilir. Qclipboard::setText() fonksiyonunu çağırmak suretiyle metni panoda 
hem bu programın hemde sade metin ile çalışabilen diğer bütün programların emrine amade 
edebiliriz. Kullanmış olduğumuz, tab ve yeni satır işaretlerini içeren format, Microsoft Excel 
başta olmak üzere bir çok diğer programlar tarafından anlaşılmaktadır. 

QTableSelection Spreadsheet : :selection() 
{ 

if (QTable: ıselection (0) .isEmpty () ) 

return QTableSelection (currentRow ( ) , currentColumn ( ) , 

currentRow ( ) , currentColumn ( ) ) ; 

return QTable : : selection (0) ; 
} 

Hususu selectionO fonksiyonu hali hazırda seçilmiş olan alanı verir. Bu fonksiyon 
Qtable::selection() fonksiyonuna itimad eder. Qtable:: selectionO fonksiyonu seçilmiş alanları 
numaralandırmaktadır. Biz yanhzca bir alanın seçilmesine izin verdiğimiz için O numaralı 
alanı taleb ediyoruz. Hiç bir hücre veya hücreler gurubunun seçilmemiş olmasıda tabiiki 
mümkün. Bunu sebebi QTable m aktif hücreyi seçilmiş ittihaz etmez. Bu davranış aslında 
makul olmakla birlikte bizim için en müsait bir seçenek olmadığından biz burada selectionO 
fonksiyonunu yeniden tanımladık ve o artık varsa seçilmiş olan alanı aksi takdirde aktif 
hücreyi verir. 

void Spreadsheet : ıpaste ( ) 

{ 

QTableSelection sel = selection (); 

QString str = QApplication : : clipboard ( ) ->text ( ) ; 

QStringList rows = QStringList : : split ( "\n" , str, true) ; 

int numRows = rows.size(); 

int numCols = rows . f irst ( ) . contains ( "\t " ) + 1; 

if (sel . numRows ( ) ^ sel . numCols ( ) != 1 
&& (sel . numRows ( ) != numRows 
I I sel .numCols O != numCols)) 

{ 

QMessageBox : : Information (t his, tr ( "Spreadsheet" ) , 

trUtf 8 ( "Kopyalanan ve yap t rlacak olan alanlar " 
"farkl oldu u için yap t rma" 
"ilemi gerçekle t ir ileme di . " ) ) ; 
return; 
} 
for (int 1=0; i < numRows; ++i) 



{ 



QStringList cols = 

OStringList : : split ( "\t", rows[i], true); 
for (int j = 0; j < numCols; ++j) 

{ 

int row = sel.topRow() + i; 
int col = sel . leftCol ( ) + j; 
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if (row < NumRows && col < NumCols) 
setFormula (row, col, cols[j]); 

} 
} 
somethingChanged ( ) ; 



} 



pasteO dilimi Düzenle I Yapıştır dilimine tekabül eder. Panodaki metni alıp sakin 
QstringList::split() fonksiyonunu çağırmak suretiyle metni QStringList tğrğnde bir listeye 
çeviriyoruz. Her satır QStringList listesinin bir elamanı olur. Daha sonra kopya yapılacak 
alanın ebatlarını belirliyoruz. Satır sayısı QStringList listesindeki elemean sayısına eşittir. 
Sütun sayısı ise ilk satırdaki tab sayısı artı birdir. Sadece bir hücre seçilmiş ise biz onu 
yapıştırma alanının sol üst kmşesi ittihaz ediyoruz. Aksi taktirde hali hazırdaki seçilmiş 
alanı yapıştırma alanı olarak algılıyoruz. Yapıştırma işlemini ifa etmek için her bir satırı, tab 
işaretini ayırıcı olarak kullanmak suretiyle QStringList::split() fonksiyonun çağırıp, 
hücrelere bölüyoruz. Şekil 4.8 yapıştırma işleminin ihtiva ettiği adımları izhar etmektedir. 

"Red\tGreen\tBlue\nCyan\tMagenta\tYellow" 

["Red\tGreen\tBlue'\ "Cyan\t Magenta\t Yellow"] 

["Red","Green'\ "Blue"] 
[ "Cyan", "Magenta", "Yellow"] 





H 


1 


J 


27 


Red 


Green 


Blue 


28 


Cyan 


Magenta Vellov 



Şekil 4.8: Panodaki metnin elektronik çizelgeye yapıştırılması. 

void Spreadsheet : : del ( ) 

{ ■: \ 

QTableSelection sel = selection(); 

for (int 1=0; 1 < sel . numRows ( ) ; ++1) 



{ 



} 



for (İnt j = 0; j < sel . numCols ( ) ; ++j) 

delete celi (sel . topRow ( ) +1, sel. lef t Col () +j) ; 



clearSelection () ; 



} 



del() dilimi Düzenle I Sil menüsüne tekabül eder. Seçilmiş alanı silmek için delete komutunu 
kullanarak her bir Celi nesnesini silmek kafidir. QTable ihtiva ettiği QTableItems ferdlerinin 
silinmiş olduğunun farkına varır ve kendisini ekranda yeniden gösterir. cell() fonksiyonunu 
silinmiş olan bir hücre için çağırırsak o boş bir müşir verir. 

vold Spreadsheet : : selectRow ( ) 

{ 

clearSelection ( ) ; 

QTable : : selectRow (currentRow ( ) ) ; 
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void Spreadsheet : : selectColumn ( ) 

{ 

clearSelection ( ) ; 

QTable : : selectColumn (currentColumn ( ) ) ; 
} 

void Spreadsheet :: selectAll ( ) 

{ 

clearSelection ( ) ; 

selectCells (O, O, NumRows - 1, NumCols - 1); 
} 

selectRow(), selectColumnO, ve selectAUO fonksiyonları sırasıyla Düzenle I Seç I Sıra, 
Düzenle I Seç I Sütun, ve Düzenle I Seç I Hepsini menülerine tekabül ederler. Bizim yazdığımız 
kod QTable sınıfın selectRow(), selectColumnO, ve selectCellsO fonksiyonlarına itimad eder. 

void Spreadsheet :: findNext (const QString &str,bool caseSensitive) 
{ 

int row = currentRow ( ) ; 

int col = currentColumn ( ) + 1; 

while (row < NumRows ) 

{ -:| 

while (col < NumCols) •'' 

{ 

if (text(row, col) . contains (str, caseSensitive) ) 

{ 

clearSelection ( ) ; 
setCurrentCell (row, col) ; 
setActiveWindow ( ) ; 
return; 

} 

++COİ; 
} 

col = 0; 
++row; 
} ' ' I 

qApp->beep ( ) ; 
} 

fîndNext() dilimi imlecin sağındaki hücreden başlayarak cari satırın sonuna varıncaya kadar 
arar, şayet satırın sonuna varıldıysa bir sonraki satırın başından aramaya devam eder. Bu 
işlem aranan metin bulununcaya yada en son hücreye varıncaya kadar devam eder. Mesela 
cari hücre C27 ise, biz D27, E27, &, Z27 hücrelerini, daha sonrada A28, B28, C28, &, Z28, 
vesaire Z999 hücresine varıncaya kadar arıyoruz. Aranılan text bulundu ise hali hazırdaki 
seçilmiş alanı iptal edip imleci aradığımız metni içeren hücreye yerlerştiriyoruz ve bu 
çizelgeyi içeren pencereyi aktif yapıyoruz. Şayet aranılan metin bulunamadı ise bu durumda 
program küçük bir ses (beep) çıkararak aramanın başarısızlıkla sonuçlandığını gösterir. 

void Spreadsheet :: findPrev (const QString &str, bool caseSensitive) 

{ 

int row = currentRow ( ) ; 

int col = currentColumn ( ) - 1; 
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while (row >= 0) 
{ 



while (col >= 0) 
{ 



} 

col = 

— row; 



if (text(row, col) . contains (str, caseSensitive) ) 

{ 

clearSelection ( ) ; 
setCurrentCell (row, col); 
setActiveWindow ( ) ; 
return; 

} 

— col; 

NumCols 



1; 



} 

qApp->beep ( ) ; 



} 



fîndPrevO dilimi fîndNext() dilimine çok benzer. Aralarındaki tek fark fîndPrevO 
fonksiyonunun geriye doğru arayıp Al hücresinde durmasıdır. 

Diğer Menlilerin Oluşturulması 

Şimdi Aletler ve Seçenekler menlileri için gerekli olan dilimleri oluşturacağız. 



I Tools 



RecaJculaıte P9 

Şort... 



Optiors 

v* Şhov/' Grid 

^ Auto-recalculate 



Şekil 4.9: Spreadsheet programının Aletler ve Seöenekler menlileri. 

void Spreadsheet : : recalculate ( ) 

{ '■■ \ 

int row; 

for (row = 0; row < NumRows; ++row) 

{ 

for (int col = 0; col < NumCols; ++col) 

{ 

if (cell(row, col)) 
cell(row, col) ->setDirty ( ) ; 
} 

} 

for (row = 0; row < NumRows; ++row) 



{ 



for (int col = 0; col < NumCols; ++col) 

{ 

if (cell(row, col)) 
updateCell (row, col); 
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recalculateO dilimi Aletler I Yeniden Hesapla menüsüne tekabül eder. Bu dilim Spreadsheet 
tarafındanda gerektiğinmde çağrılmaktadır. Bütün hücreleri ziyaret edip yeniden 
hesaplanması gereken her hücre için setDirtyO fonksiyonunu çağırarak nişanlıyoruz. Bu 
aşamadan sonra ne zamanki QTable, text() fonksiyonunu bir hücrenin deşerini elde edip 
ekranda görüntülemek için çağırırsa o anda hücrenin değeri yeniden hesaplanır. Sonra biz 
updateCellO fonksiyonunu kullanmak suretiyle bütün elektronik öizelgenin yeniden 
görüntülenmesini sağlıyoruz. QTable daki yeniden görüntüleme işlemini yapan kod text() 
fonksiyonunu çağırarak herbir hücrenin değerini görüntülemek üzere elde eder. Daha ünce 
her bir hücre için setDirtyO fonksiyonunu çağırmış olmamız hasebiyle text() fonksiyonu en 
son hesaplanan değerleri dönderir. Hesaplamalar Celi sınıfı tarafından ifa edilir. 

void Spreadsheet :: setAutoRecalculate (bool on) 
{ 

autoRecalc = on; 

if (autoRecalc) 

recalculate ( ) ; 
} 

setAutoRecalculateO dilimi Seçenekler I Otomatikmen Yeniden Hesapla menüsüne tekabül 
eder. Eğer bu seşenek tercik edilmiş ise, elektronik öizelgenin güncelliğini garanti etmnek 
iöin, biz hemen bütün hücreleri yeniden hesaplıyoruz. Bundan sonra recalculateO fonksiyonu 
somethingChangedO tarafından bir değişikliği mütaakip otomatik olarak çağrılır. 

Seçenekler I Izgarayı Göster menüsü için hususi bir kod yazmamıza gerek yok çünkü QTable 
zaten setShowGrid(bool) dilimini tedarik etmektedir. Geriye kalan sadece Spreadsheet:: 
sortO fonksiyonudurki buda MainWindow::sort() tarafından çağrılmaktadır: 

void Spreadsheet :: şort (const SpreadsheetCompare &compare) 

{ 

vector<QStringList> rows; 

QTableSelection sel = selection(); t, , 

int i; 

for (1=0; 1 < sel . numRows ( ) ; ++1) 

{ 

OStrlngLlst row; 

for (İnt j = 0; j < sel . numCols ( ) ; ++j) 

row . push_back ( f ormula (sel . topRow ( ) + 

1, sel.leftCol () + j) ) ; 

rows .push_back (row) ; 

} 

stable_sort (rows .begln ( ) , rows.end(), compare) ; 

for (1=0; 1 < sel . numRows ( ) ; ++1) 

{ 

for (İnt j = 0; j < sel . numCols ( ) ; ++j){ 
setFormula (sel . topRow ( ) + 1, 

sel.leftCol O + j, rows[l][j]); 

} 

} 

clearSelectlon ( ) ; 

somethlngChanged ( ) ; 
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} 

Tasnif yada sıralama işlemi tasnif anahtarlarını kuUnarak seçilmiş olan hücreler için 
gerçekleştirilir. Seçilmiş olan hücrelerin her bir satırını yada sırasını bir QStringList 
listesinde tutuyoruz ve daha sonra bu satırları bir vektörde (vector<T>) topluyoruz. 
vector<T> sınıfı standart C++ m bir parçasıdır; onbirinci bölümde muhtevi sınıfları altında 
açıklanacaktır. Kolaylık olsun diye değerler yerine formülleri kullanarak sıralamayı 
gerçekleştiriyoruz. . ^— _-. . 
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[ "Edsger'\ "Dijkslra'\ "1 930-05-1 1 " ] 
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[ "Niklaus". "Wirth'\ "1 934-02-1 5" ] 
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[ "Donald". "Knuth". "1 938-01 -1 0" ] 



Şekil 4.10: Seçilmiş olan hücrelerin sıralar halinde bir vektörde tutulması. 

Satırların tasnif işlemini geröekleştirmek için bir standart C++ da yer alan olan stable_sort() 
fonksiyonunu çağırıyoruz. stable_sort() fonksiyonunun bir başla iteratörüne, bir bitir 
iteratörüne ve birde kariılaştırma fonksiyonuna ihtiyacı vardır. Karşılaştırma yada kıyas 
vazifesine gören fonksiyon iki tane QStringLists türünde argüman alır ve eğer ilk argüman 
ikincisinden küçük ise müsbet (true) aksi taktirde menfî (false) değerini üretir. Karşılaştırma 
fonksiyonu olarak kullandığımız kıyas nesnesi aslında bir fonksiyon değildir andcak, 
birazdan göreceğimiz gibi, fonksiyonmü gibi kullanılabilir. 
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Şekil 4.11: Tasnif işleminden sonra datanın hücrelere geri kopyalanması. 

Tasniş işlemini geröekleştirdikten sonra datayı tabloya gerş kopyalıyo, seçilmiş alanı 
temzliyor ve somethingChangedO fonksiyonun çağırıyoruz, spreadsheet.h dosyasında 
SpreadsheetCompare sınıfı üu ürkilde tanımlanmıştı: 

class SpreadsheetCompare 



public : 



bool operatör O (const QStringList &rowl, 

const OStringList &row2) const; 
enum { NumKeys = 3 } ; 
int keys [NumKeys] ; 
bool ascending [NumKeys ] ; 



}; 



SpreadsheetCompare sınıfı () operatörü tanımlaması itibariyle farklılık arzeder. Bu 
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operatörün tanımlanmış olması bu sınıfı sanki bir fonksiyonmüş gibi kullanmamızı sağlar. 

Bu tür sınıflara "functors^^". Fanktörlerin nasıl çalıştığını anlamak için basit bir misal ile 

başlayacağız: 

class Square 

{ 

public : 

int operatör O (int x) const { return x ^ x; } 

} ; 

Square sımfimn sadece bir fonksiyonu vardır ki oda operator()(int) operatörüdür. Bu 
fonksiyon argümanının karesini üretir. Fonksiyona normal bir isim (mesela ompute(int)) 
vermey yerine operator()(int) diye adlandırmış olmamız Square türündki bir nesneyi 
fonksiyon olarak kuUanmamaıza imkan sağlar: 

Square square; 
int y = square(5); 

Şimdi SpreadsheetCompare sınıfını içeren bir misali ele alalım: 

QStringList rowl, row2; » 

SpreadsheetCompare compare; '• J 

if (compare (rowl, row2)) 

{ 

// rowl is less than row2 

} 

compare nesnesi sanki o normal compareO isminde bir fonksiyonmüş gibi kullanılır. İlave 
olarak sınıfın üye değişkenlerinde saklanmış olan tasnif anahtarlarına ve tasnif 
sıralamalarına ulaşabilir. 

Bu yaklaşıma bir alternatif olarak tasnif anahtarlarını ve sıralarını küresel (global) 
değişkenlerde saklayıp normal bir compareO fonksiyonu kullanmak olurduç Ancak küresel 
değişkenler vasıtası ile haberleşme zarif olmadığı gibi bulması zor lan hata veya çaparlara 
yol aöabilir. Fanktörs stable_sort() gibi template fonksşyonlarla kullanma hususunda normal 
fonksiyonlardan daha elverişlidirler. 

İşte elektronik çizelge programından iki satırı karşılaştıran fonksiyon: 

bool SpreadsheetCompare :: operatör O (const QStringList &rowl, 
const OStringList &row2) const 

{ 

for (int i = 0; i < NumKeys; ++i) 

{ 

int column = keys[i]; 
if (column != -1) 

{ 

if (rowl [column] != row2 [column] ) 

{ 

if (ascending [i] ) 
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return rowl [column] < row2 [column] ; 
else 

return rowl [column] > row2 [column] ; 
} 
} 
} 

return false; 
} 

İlk satırın ikinci satırdan küçük olması durumunda müsbet (true), aksi taktirde menfî (false) 
değerlerini üretir. Standart stable_sort() fonksiyonu bu fonksiyonun ürettiği değerleri 
kullanarak rasnif işlemini ifa eder. SpreadsheetCompare nesnesinin keys ve ascending 
listeleri MainWindow::sort() fonksiyonunda doldurulmaktadırlar (ikinci bölümde gösterildi). 
Her bir key (anahtar) bir sütun indeksi, yada -1 ("None^^"). 

İki satırdaki mütekabil hücre iöeriklerini sırasıyla kıyas ediyoruz. Bir fark bulur bulmaz 
müsbet yada menfî değerini geri gçnderiyoruz. Eğer bütün karşılaştırmalar eşit ise menfi 
geri gçnderiyoruz. stable_ sortO fonksiyonu satırların rasnif den önceki durumlarını göz 
önünde bulundurarak berabere kalma durumlarını çözüyor; rowl (satiri) , row2 (satır2) den 
önce geldi ise ve herhangi birisi diğerinden küçük değil ise rowl yerini mhafaza eder. 
std::stable_ sortO fonksşyonunu bundan daha meşhur ancak daha az tutarlı olan std::sort() 
fonksiyonundan temyiz edende budur. 

Böylece Spreadsheet sınıfını tamamlamış olduk. Geleck kısımda Celi sınıfın yeniden gözden 
geçireceğiz. Bu sınıf hücre formüllerini ihtiva etmekle beraber Spreadsheet tarafından 
yeniden hesaplanan değerlerin gösterilmesi maksadıyla çağrılan text() fonksiyonun yeniden 
tanımlanmış halinide içerir. 

QTableItem dan Altsınınf Oluşturulması 

Celi sınıfı QTableItem m bir altsınıfıdır. Bu sınıf Spreadsheet sınıfı ile gayet elverişli bir 
şekilde çahşmaıs için tasarlanmıştır ancak aralarındaki bağ gayet zayıf olduğundan Celi 
sınıfı her hangi bir QTable ile kullanılabilir. İşte başlık dosyası: 

#ifndef CELL_H 

#define CELL_H 

#include <qtable.]ı> 

#include <qvariant .]ı> 

class Celi : public QTableItem 

{ 

public : 

Cell(QTable ^table, const QString &formula) ; 

void setFormula (const QString &formula) ; 
OString formula() const; 
void setDirty(); 
OString text() const; 
int alignment() const; 

'' hiç 
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private : 

QVariant value() const; 

QVariant evalExpression (const QString &str,int &pos) const; 
QVariant evalTerm (const QString &str, int &pos) const; 
QVariant evalFactor (const QString &str, int &pos) const; 

OString formulaStr; 

mutable QVariant cachedValue; 

mutable bool cachelsDirty; 

}; 

#endif 
Celi sınıfı üç hususi değişken ilave etmek suretiyle QTableItem sınıfını temdid etmektedir: 

• formulaStr değişkeni hücre formülünü QString olarak muhafaza eder. 

• cachedValue değişkeni hücrenin değerini Qvariant olarak "cach^^" eder. 

• cachelsDirty is true if the cached value isn t up to date. 

QVariant çoğu C++ ve Qt data türlerini muhafaza edebilir. Bizim bunu kullanmamızın 
sebebi bazi hücreleri double türünde bir değer bazılarımnda QString türünde bir değer 
içermeleridir. 

cachedValue ve cachelsDirty değişkenleri bir C++ anahtar sözcüğü olan mutable ile 
tanımlandılar. Buda bizim bu değişkenleri const fonksiyonları işerisinde değiştirmemize izin 
verir. Alternatif olarak her text() fonksiyonu çağrıldığında değerleri yeniden hesaplamakta 
mümkün, ancak bu gereksiz yere verimliliği düşürür. 

Dikkat edilirse Q_OBJECT makrosu sınıfın tanımında yer almamaktadır. Celi sinyal ve 
dilimleri olmayan normal bir C++ sımfıdıri. Aslında QTableItem, QObject sınıfının varisi 
omadığından şu haliyle Celi sınıfında sinyal ve dilimlerin yer alması mümkün değildir. 
Verimlilği düşürmemek için Qt nin efrad (items) sınıfları QObject sınıfının varisleri 
yapılmamışlardır. Sinyal ve dilimlerin gerekmesi durumunda onlar efradı ihtiva eden alet 
iöerisinde tanımlanabilirler yada nadiren müteaddid veraset kullanarak QObject sınıfının alt 
sınıfı yapılabilirler. İşte cell.cpp dosyasının baş kıasmı: 

#include <qlineedit .h> 

#include <qregexp.h> 

#include "cell.h" 

Celi: :Cell (QTable ^table, const QString &formula) 

: QTableItem(table, OnTyping) 
{ 

setFormula (formula) ; 
} 

Yapıcı (constructor ) QTable m bir müşirini ve bir formül gerektirmektedir. Müşir 
QTableItem yapıcısına gönderilir ve daha sonra bu müşire Qtableltem::table() vasıtası ile 
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ulaşılabilir. Temel sınıfın (Qtableltem) ikinci argümanı olan OnTyping^^ ise muharririn 

(editör) kullanıcı aktif hücreye yazmasına başlar başlamaz gözükmesi anlamına gelir. 

void Celi : : setFormula (const QString &formula) 

{ 

formulaStr = formula; 

cachelsDirty = true; 
} 

setFormulaO fonksiyonu hücrenin formülünü tesbit eder. Aynı zamanda cachelsDirty 
değişkeninin değerimde müsbet (true) yapar ki buda cachedValue değerinin kullanılmadan 
evvel yeniden hesağlanması gerektiğini ifade eder. Bu fonksiyon Celi sımdımn yapıcısı ve 
Spreadsheet:: setFormulaO fonksiyonları tarafından çağrılır. 

OString Celi :: formula ( ) const 
{ 

return formulaStr; 

} 
formulaO fonksiyonu, Spreadsheet::formula() tarafından çağrılır. 

void Celi : : setDirty ( ) 
{ 

cachelsDirty = true; 
} 

setDirtyO fonksiyonu hücrenin değerinin yeniden hesaplanmasını zorunlu kılmak 
maksadıyla çağrılır. Bu fonksiyonun yaptığı tek şey cachelsDirty değişkeninin değerini 
müsbet (true) olarak deüiştirmektir. Değerin yeniden hesaplanması işlemi ne zaman gerekli 
ise o zaman gerçekleştirilir. 

OString Cell::text() const 
{ 

if (value O .isValidO ) - 

return value (). toString () ; î ^^ ı 

else return "####"; 
} 

text() fonksiyonu Qtableltem dan miras kalmakla birlikte burada yeniden 
tanımlanmaktadır. Elektronik öizelgede görüntülenmesi gereken metni getirir. Hücrenin 
değerinin hesaplanmasında valueO fonksiyonuna itimad etmektedir. Şayet hücrenin değeri 
muteber değil ise yani geçersiz ise (bu genelde formülün yanlış olmasından kaynaklanır) bu 
durumda "####" metnini geri gönderiyoruz . 

text() fonksiyonu tarafından kuUmlan valueO fonksiyonu QVariant türünde bir dğişken 
üretir. QVariant, double ve QString gibi değişik data türlerini muhafaza edebilir ve üye 
fonksiyonları vasıtasıyla variant diğer data türlerine çevrilebilirler. Mesela, double türünde 
bir değer içeren varıand içim toStringO fonksiyonunu çağırmakla double, metin olarak temsil 
edilebilir. Varsayılan (default) yapıcıyı kullanarak husule getirilen QVariant muteber yada 
geöerli bir variant değildir. 



yazmaya başlar başlamaz 
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int Celi : : alignment ( ) const 

{ 

if (value ( ) . type ( ) == QVariant : : String) 

return AlignLeft | AlignVCenter; 
else 

return AlignRight | AlignVCenter; 
} 

alignment^^O fonksiyonu aslen Qtableltem yer almakla birlikte biz burada onu yeniden 
tanımladık. Bu fonksiyon bir hücrenin metni için hiza ayarını dönderir. Biz matinleri sola 
yanaşık ve rakamları sağa yanaşık olarak hizalamayı tercih ettik. Düşey doğrultudaki 
hizalamaya gelince bütün değerler merkezi olarak hizalanırlar. 

const QVariant Invalid; 
QVariant Celi :: value ( ) const 

{ 

if (cachelsDirty) 
{ 

cachelsDirty = false; 

if (formulaStr .startsWith (" ")) 

{ 

cachedValue = f ormulaStr .mid (1) ; 

} 

else if (formulaStr . startsWith ("=") ) 

{ 

cachedValue = Invalid; 

OString expr = formulaStr .mid (1 ) ; 

expr . replace ( " ", ""); 

int pos = 0; 

cachedValue = evalExpression (expr, pos); 

if (pos < (int ) expr . length ( ) ) 

cachedValue = Invalid; 
} 
else 

{ ''^1 

bool ok; 

double d = formulaStr . toDouble (&ok) ; 
if (ok) 

cachedValue = d; 
else 

cachedValue = formulaStr; 
} 
} 

return cachedValue; 
} 

Hususi valueO fonksiyonu hücrenin değerini dönderir. Eğer cachelsDirty değişkeninin değeri 
müsbet ise hücrenin değeri yeniden hesaplanmalıdır. 

Eğer formül tek tırnak işareti ile başlarsa (mesela, "'12345"), hücrenin değeri metnin ikinci 
indexinden sonuna kadar olan değerdir. (Tek tırnak ilk indekste yer almaktadır) 



16 
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Eğer formül "=" ile başlarsa metnin ikinci indexden başlayarak varsa bütün boşlukları 
siliyoruz. Daha sonra evalExpression() fonksiyonunu çağırarak formülü değerlendiriyoruz, 
pos argümanı "passed by reference" türünde bir argümandır ve tahlilin (parsing) 
başlayacağı indexi gösterir. evalExpression() çağrıldıktan sonra pos deüişkeni başarılı bir 
şekilde tahlil edilebilen mentnin uzunluğuna eşitlenir. Eğer tahlil işlemi, metnin sonuna 
ermeden, başarısızlıkla sonuçlandı ise cachedValue deüişkeninin değerini Invalid (geşersiz) 
olarak değiştiriypruz. 

Eğer formül tek tırnak işareti veya eşitlik işareti ('=') ile başlamıyor ise toDoubleO 
fonksiyonunu çağırarak onu real sayıya çevirmeye cehd ediyoruz. Eğer çeviri başarılı ise 
cachedValue değişkenine budeğeri yerleştiriyoruz; aksi takdirde cachedValue değişkenine 
meni aynen yerleştiriyoruz. Mesela, formülün 1.50 olduğunu varsayarsak ve bunu 
toDoubleO fonksiyonu ile doğal sayıya çevirmeye kalktığımızda elde edeceğimiz değer 1.5 dir, 
binaenaleyh "Dünaynm Nüfusu" formülünü toDoubleO fonksiyonu ile doğal sayıya çevirmeye 
kalkarsak ok değişkeni menfîye ayarlanmış olur ve elde edeceğimiz değer 0.0 dır. 

valueO fonksiyonu "const" bir fonksiyondur. Bu yüzden cachedValue ve cachelsValid 
deişkenlerini mutable olarak tammladıkk taki derleyici bu değişkenleri const bir fonksiyon 
içerisinde değiştimemize izin versin. valueO fonksiyonununu const fonksiyon yerine normal 
fonksiyon yapıp mutable anahtar sözcüğünü kullanmamayı düşünebilirsiniz ancak valueO 
fonksiyonu const bir fonksiyon olan text() tarafından çağrıldığından onu derleyemezsiniz. 
C++ diline caching ve mutable genelde beraber kullanılırlar. 

Formüllerin tahlili haricinde Spreadsheet programını böylece tamalamış olduk. Bu bölümün 
geri kalan kısmı evalExpression() fonksiyonu ile evalTermO ve evalFactorO yardımcı 
fonksiyonlarını içine almaktadır. Kode biraz karmaşık ancak programın tamam olması iöin 
buraya dahil edildi. Bu kodun GUI ile ilgisi olmadığı içim arzu ederseniz bu kısmı atlayıp 
beşinci bölümden devam edebilirsiniz. 

evalExpression()^^ fonksiyonu elektronik çizelge ibarelerini değerlendirir. İbare birbirlerin 
toplama ('+') veya çıkarma ('-') işaretleri ile ayrılmış terimler topluluğu olarak tanımlanır; 
mesela, "2*C5+D6" bir ibare olup, "2*C5" ibarenin ilk terimi ve D6 ise ikinci terimidir. 
Terimler ise yine birbirlerinden çarpma ('*') veya bölme (7) işaretleri ile ayrılmış faktörler 
topluluğu olarak tanımlanır; mesela, "2*C5", ilk faktörü "2" ve ikinci faktörü "C5" olan bir 
terimdir. Faktör ise bir sayı ("2"), bir hücre pozisyonu ("C5"), veya önünde muhtemelen bir 
eksi (-) işareti bulunan parantez içine alınmış bir ibare olabilir. İbareleri terimlere ve 
terimleri faktörlere ayırmak suretiyle operatörlerin (çarpma, toplama gibi) öncelik sırasına 
göre değerlendirilmelerini garanti altına almış oluyoruz. 



ibareyi değerlendir 
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İbare 



Terim 



Faktör 



Terim 



O 



o 



Factör 



V. 



-O 




Rakam 



Hücre pozisyonu 



\ ( f^ thare 



■oy 



Şekil 4.12: Elektronik çizelge programının nahiv (sintaks) diyagramı. 



Elektronik çizelge ibarelerinin nahvi şekil 4.12 tasvir edilmektedir. Gramerdeki her bir 
sembola mğkabil (İbare, Terim, ve Faktör), Celi sınıfının bir üye fonksiyonu mevcuttur ki nu 
fonksiyon mukabili olan sembolü tahlil eder ve yapı itibarı ile sembolün yapısına benzer. Bu 
şekilde yazılmış yada tasarlanmış olan tahlil edicilere nüzulü mütedahil (recursive-descent) 
adı verilir. İbareleri tahkik eden evalExpression() fonksiyonu ile başlayalım: 

QVariant Celi : : evalExpression (const QString &str, int &pos) const 

{ 

QVariant result = evalTerm (str, pos); 
while (pos < (int ) str . length ( ) ) 



{ 



QChar op = str [pos]; 

if (op != '+' && op != '-' 

return result; 
++pos; 



QVariant term = evalTerm (str, pos); 
if (result .type ( ) == QVariant : : Double 

&& term. type O == QVariant :: Double) 

{ 

if (op == '+' ) -^ 

result=result . toDouble () +term. toDouble () ; 
else 

result=result. toDouble ( ) -term. toDouble ( ) ; 
} 

else 
{ 



result = Invalid; 



} 



} 

return result; 



} 



Önce ,evalTerm() fonksiyonunu çağırıp ilk terimi elde ediyoruz. Eğer müteakip karekter bir 
'+' veya '-' ise evalTermO fonksiyonunu ikinci defa çağırarak devam ediyoruz; aksi takdirde 
ibare bir terimden ibarettir ve bu terimi değerlendirip onu ibarenin değeri olarak geri 
gönderiyoruz. İlk iki terimin değerini hesapladıktan sonra aralarındaki operatörü (çarpa, 
toplama vesaire) kullanarak sonucu hesap ediyoruz. Eğer terimlerin her ikisininde değeri 
doğal sayı ise bu durumda sonucu double olarak hesaplıyoruz, aksi halde sonucu Invalid 
(geçersiz) olarak belirliyoruz. Bu şekilde bütün terimleri bitirinceye kadar devam ediyoruz. 
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Bunun doğru olarak öalışmasımn sebebi toplama ve şıkarma işlemkerinin soldan sağa doğru 

(left-associative) yapılmalarıdır; yani, "1+2+3" ibaresi "l+(2+3)" olarak değil bilakis 

"(l+2)+3" olarak algılanır ve değerlendirilir. 

QVariant Celi : : evalTerm (const QString &str, int &pos) const 
{ 

QVariant result = evalFactor (str, pos); 

while (pos < (int ) str . length ( ) ) 

{ 

QChar op = str [pos ]; 

if (op != '^' && op != '/' ) 

return result; 
++pos; 

QVariant factor = evalFactor (str, pos); 
if (result .type ( ) == QVariant : : Double 
&& factor .type ( ) == QVariant :: Double) 

{ 

if (op == '^' ) 
{ 

result=result. toDouble ( ) ^factor . toDouble ( ) ; 
} 

else 
{ 

if (factor. toDouble O == 0.0) 

result = Invalid; 
else 

result = result .toDouble ( ) / factor . toDouble () ; 
} 
} 

else 
{ 

result = Invalid; 
} 

} î : ■ 

return result; 

} 

evalTermO^^ fonksiyonu evalExpression() fonksiyonuna çok benzemekle birlikte toplama ve 
çıkarma ilemleri yerine çarpama ve bölme işlemleri ile iştigale etmektedir. evalTermO 
fonksiyonunda göz önünde bulundurulması gereken tek husus sıfıra bölme işleminden 
kaçınmaktır. Genelde yuvarlama hataları yüzünden oating point (kayan noktalı) değerlerin 
eşitlik testi tavsiye edilmez ancak sıfıra bölme işlemindan kaşınmak için bunu yapmakta bir 
sakınca yoktur. 

QVariant Celi :: evalFactor (const QString &str, int &pos) const 
{ 

QVariant result; bool negative = false; 

if (str[pos] == '-' ) 

{ 

negative = true; ++pos; 



terimi değerlendir, terimin değerini hesapla 
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} 

if (str [pos] == ' ( ' ) 

{ 

++pos; 

result = evalExpression (str, pos); 

if (str [pos] != ' ) ' ) 
result = Invalid; 

++pos; 
} 

else 
{ 

QRegExp regExp (" [A-Za-z] [1-9] [0-9] {0,2}"); 

QString tolcen; 

w]ıile (str [pos] . isLetterOrNumber ( ) I I str [pos] == '.') 

{ 

tolcen += str [pos]; ++pos; 

} 

if (regExp . exactMatc]ı (tolcen) ) 

{ 

int col = to]cen[0] .upper() .unicode() - 'A' ; 
int row = tolcen .mid (1 ) . tolnt ( ) - 1; 
Celi ^c = (Celi ^ ) table ( ) ->item (row, col); 
if (c) 

result = c->value(); 
else 

result = 0.0; 
} 
else { 

bool o]^; 

result = tolcen . toDouble (&olc) ; 

if (!o]c) 

result = Invalid; 
} 
} 
if (negative) î , ı 

if (result . type ( ) == QVariant : : Double) 

result = -result .toDouble O ; 
else 

result = Invalid; 
} 

return result; 
} 

evalFactorO^^ fonkisyonu evalExpression() ve evalTermO fonksiyonlarından biraz dahah 
karmaşıktır. Önce faktürün önünde eksi işareti olup olmadığını tesbit etmekle işe başlıyoruz. 
Daha sonra faktörün bir açık parantez ile başlayıp başlamadığına bakıyoruz. Eşer faktör açık 
parantez ile başlıyor ise evalExpression() fonksiyonunu öağırmak suretiyle parantez 
iöerisindeki ibareyi değerlendiriyoruz. İşte tahlil edicinin (parser) bu aşamasında tedahül 
(recursion) veya tedai diye tabir edilen makanizma yer alır; evalExpression() fonksiyonu, 
evalTermO fonksiyonunu, oda evalFactorO fonksiyonunu, buda tekrar evalExpression() 



faktörü değerlendir 
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fonksiyonunu şağırır. 

Eğer faktör mütedahil (nested) ibare değil ise, faktörün bir sonraki alt birimini çıkarıyoruz. 
Eğer bu alt birim QRegExp kriterine uygun ise, onu hücre pozisyonu olarak algılıyor ve bu 
pozisyondaki hücrenin değerini valueO fonksiyonunu kullanarak aide ediyoruz. Hücre 
elektronik çizelgenin herhangi bir noktasında yer alabileceği gibi başka hücrelerede bağımlı 
olabilir. Hücrelerin yekdiğerine bağlılıkları bir problem teşkil etmez; her bir baüımhhk için 
valueO fonksiyonu çağrılır ve "kirli" yani yeniden hesaplanması gereken hücreler tahlil edilir 
taki bütün bağımlılıklar halledilsin. Eğer faktörün alt birimi hücre pozisyonu değil ise onu 
sayı olarak algılıyoruz. 

Al hücresinin "=A1" formülünü ihtiva etmesi durumunda ne olur? Yada Al hücresi "=A2" 
formülünü ve A2 hücreside "=A1" formülünü içeriyor ise nasıl bir sonuç elde edilir? Her ne 
kadar kısır döngüleri tahlil etmek için hususi bir kod yazmadıysakta, hali hazırdaki kod 
böyle durumların farkına varıp geçersiz bir Qvariant döndermektedir. evalExpression() 
fonksiyonunu çağırmadan önce valueO fonksiyonu içerisinde cachelsDirty değişkenini menfî 
ve cachedValue değişkenini geçersiz (Invalid) yaptığımızdan dolayı bir problem 
iıkmamaktadır. Eğer evalExpression() fonksiyonu tedai (recursively) bir şekilde aynı hücre 
için çağırırsa, anında valueO fonksiyonu "Invalid" değerini geri gönderir ve ibarenin 
tamamının değeri geçersiz olarak belirlenir. 

Bölece elektronik çizelge programının tahlil edicisini tamamlamış olduk. Bu aşamada artık 
tahlil edicinin, sum() ve avgO gibi standart elektronik çizelge fonksiyonlarını anlayabilmesi 
için ilaveler (faktörün gramer tanımını genişleterek) yapmak kolay olsa gerektir. Bir diğer 
kolay ilavede "+" operatürünün sadece sayıları değil aynı zamanda metinleride toplama 
(yada ekleme) yeteneği vermektir. Bu gramerde her hangi bir değişikliği gerektirmez. 



